Zum Hauptinhalt springen

Agents hinzufügen und verbinden

Ein Workflow in 42°OS besteht aus einzelnen Agents — jeweils ein Agent für eine bestimmte Aufgabe. In diesem Kapitel lernst du wie du Agents zum Canvas hinzufügst, konfigurierst und miteinander verbindest.

Was ist ein Agent?​

Ein Agent ist ein Baustein mit einer klar definierten Aufgabe. Es gibt Agents für das Empfangen von E-Mails, das Lesen von Dateien, das Ausführen von KI-Anfragen, das Schreiben in eine Datenbank und vieles mehr.

Agents kommunizieren über Nachrichten: jeder Agent empfängt eine Nachricht, verarbeitet sie und gibt eine (veränderte oder neue) Nachricht an den nächsten Agent weiter. Diese Nachricht ist immer eine JSON-Struktur — ein Datenbehälter, der im Verlauf des Workflows mit Informationen befüllt wird.

Einen Agent hinzufügen​

  1. Klicke im Canvas auf Agent hinzufügen oder auf das +-Symbol
  2. Es öffnet sich die Agent-Bibliothek mit allen verfügbaren Agents
  3. Wähle den gewünschten Agent aus — über die Suche findest du ihn schnell
  4. Der Agent erscheint als Block auf dem Canvas

Einen Agent konfigurieren​

Jeder Agent hat eine Konfigurationsansicht, die du durch Klick auf den Agent-Block öffnest. Hier stellst du ein:

  • Welche Daten der Agent aus der eingehenden Nachricht liest (über sogenannte Keys — Felder in der JSON-Struktur)
  • Was der Agent tut — z. B. welche Datei er liest, welchen Prompt er an eine KI schickt, in welche Datenbanktabelle er schreibt
  • Was er ausgibt — unter welchem Key er sein Ergebnis in der Nachricht ablegt
Input-Key und Output-Key

Die meisten Agents haben mindestens einen Input-Key (wo liest er aus der Nachricht?) und einen Output-Key (wohin schreibt er sein Ergebnis?). Diese Keys sind wie Feldnamen — du kannst sie frei wählen, solange du konsistent bleibst und nachfolgende Agents denselben Key zum Lesen verwenden.

Agents verbinden​

Um zwei Agents miteinander zu verbinden, ziehst du eine Linie vom Ausgang des ersten Agents zum Eingang des zweiten.

Die Verbindung bestimmt den Datenfluss: die Ausgabe des ersten Agents wird zur Eingabe des zweiten. So entsteht Schritt für Schritt der Verarbeitungsweg des Workflows.

Trigger Agent
     ↓
Verarbeitungs-Agent
     ↓
Ausgabe-Agent

Verzweigungen​

Nicht jeder Workflow läuft linear durch. Mit einem Switch Agent kannst du den Verarbeitungsweg aufteilen — je nach Inhalt der Nachricht wird ein anderer Pfad weiterverfolgt. Zum Beispiel:

E-Mail Agent
     ↓
Switch Agent (nach Anhang-Typ)
     ├── PDF → PDF-Verarbeitungs-Agent
     ├── XLSX → Tabellen-Verarbeitungs-Agent
     └── Sonstiges → Benachrichtigungs-Agent

Verzweigungen werden in den Bauprinzipien (Modul 3) ausführlich behandelt.

Die Nachricht verstehen​

Das Herzstück des Datenflusses ist die Nachricht — eine JSON-Struktur, die von Agent zu Agent weitergereicht wird. Jeder Agent kann Felder hinzufügen, verändern oder lesen.

Ein einfaches Beispiel wie eine Nachricht im Verlauf eines Workflows wächst:

Nach dem E-Mail Agent:

{
  "subject": "Rechnung März 2025",
  "sender": "lieferant@beispiel.de",
  "attachment_path": "inbox/rechnung-maerz.pdf"
}

Nach dem Read File Agent:

{
  "subject": "Rechnung März 2025",
  "sender": "lieferant@beispiel.de",
  "attachment_path": "inbox/rechnung-maerz.pdf",
  "file_content": "Rechnung Nr. 2025-042 ..."
}

Nach dem Generative AI Agent:

{
  "subject": "Rechnung März 2025",
  "sender": "lieferant@beispiel.de",
  "attachment_path": "inbox/rechnung-maerz.pdf",
  "file_content": "Rechnung Nr. 2025-042 ...",
  "extracted_data": {
    "invoice_number": "2025-042",
    "total": 1428.50,
    "due_date": "2025-04-15"
  }
}

Die Nachricht ist kumulativ — sie enthält am Ende alle Informationen, die im Verlauf des Workflows gesammelt wurden. Das macht es einfach, in späteren Agents auf frühere Ergebnisse zuzugreifen.

Einen Workflow testen​

Bevor du einen Workflow in den produktiven Betrieb nimmst, testest du ihn mit dem Manual Message Agent. Dieser Agent steht am Anfang eines Workflows und erlaubt es dir, eine beliebige JSON-Nachricht manuell einzugeben — so kannst du jeden Workflow unabhängig von einem echten Trigger starten und durchlaufen lassen.

Das Testen mit dem Manual Message Agent und der Blick in den Run Inspector sind Thema des nächsten Moduls.